home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmVaCreateSimpleCheckBox.z / XmVaCreateSimpleCheckBox
Encoding:
Text File  |  2003-11-18  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_C_h_e_c_k_B_o_x - A RowColumn widget    convenience
  10.       creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/RowColumn.h>
  14.  
  15.       Widget XmVaCreateSimpleCheckBox (ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,, ccccaaaallllllllbbbbaaaacccckkkk,,,, aaaarrrrgggg............)
  16.            _W_i_d_g_e_t     ppppaaaarrrreeeennnntttt;
  17.            _S_t_r_i_n_g     nnnnaaaammmmeeee;
  18.            _X_t_C_a_l_l_b_a_c_k_P_r_o_cccccaaaallllllllbbbbaaaacccckkkk;
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_C_h_e_c_k_B_o_x creates an instance of a RowColumn
  22.       widget of type _X_m_W_O_R_K__A_R_E_A and returns the associated    widget
  23.       ID.  This routine uses the ANSI C variable-length argument
  24.       list (varargs) calling convention.
  25.  
  26.       This routine creates a CheckBox and its ToggleButtonGadget
  27.       children.  A CheckBox    is similar to a    RadioBox, except that
  28.       more than one    button can be selected at a time.  The name of
  29.       each button is button_nnnn, where nnnn is an integer from 0    to one
  30.       minus    the number of buttons in the menu.  Buttons are    named
  31.       and created in the order in which they are specified in the
  32.       variable portion of the argument list.
  33.  
  34.       ppppaaaarrrreeeennnntttt
  35.            Specifies the parent widget ID.
  36.  
  37.       nnnnaaaammmmeeee Specifies the name of the created widget.
  38.  
  39.       ccccaaaallllllllbbbbaaaacccckkkk
  40.            Specifies a callback procedure to be called when    a
  41.            button's    value changes.    This callback function is
  42.            added to    each button after creation as the button's
  43.            _X_m_N_v_a_l_u_e_C_h_a_n_g_e_d_C_a_l_l_b_a_c_k.     The callback function is
  44.            called when a button's value changes, and the button
  45.            number is returned in the cccclllliiiieeeennnntttt____ddddaaaattttaaaa field.
  46.  
  47.       The variable portion of the argument list consists of    groups
  48.       of arguments.     The first argument in each group is a
  49.       constant or a    string and determines which arguments follow
  50.       in that group.  The last argument in the list    must be    NULL.
  51.       Following are    the possible first arguments in    each group of
  52.       varargs:
  53.  
  54.       _X_m_V_a_C_H_E_C_K_B_U_T_T_O_N
  55.            This is followed    by four    additional arguments.  The set
  56.            specifies one button in the CheckBox and    some of    its
  57.            resource    values.     Following are the additional four
  58.            arguments, in this order:
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       llllaaaabbbbeeeellll
  75.            The label string, of type XmString.
  76.  
  77.       mmmmnnnneeeemmmmoooonnnniiiicccc
  78.            The mnemonic, of    type KeySym.  This is ignored in this
  79.            release.
  80.  
  81.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr
  82.            The accelerator,    of type    String.     This is ignored in
  83.            this release.
  84.  
  85.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr____tttteeeexxxxtttt
  86.            The accelerator text, of    type XmString.    This is
  87.            ignored in this release.     This is followed by one
  88.            additional argument, the    value of the resource, of type
  89.            XtArgVal.  The pair specifies a resource    and its    value
  90.            for the RowColumn widget.  This is followed by four
  91.            additional arguments.  The set specifies    a resource and
  92.            its value for the RowColumn widget.  A resource type
  93.            conversion is performed if necessary.  Following    are
  94.            the additional four arguments, in this order:
  95.  
  96.       nnnnaaaammmmeeee The resource name, of type String.
  97.  
  98.       ttttyyyyppppeeee The type    of the resource    value supplied,    of type
  99.            String.
  100.  
  101.       vvvvaaaalllluuuueeee
  102.            The resource value (or a    pointer    to the resource    value,
  103.            depending on the    type and size of the value), of    type
  104.            XtArgVal.
  105.  
  106.       ssssiiiizzzzeeee The size    of the resource    value in bytes,    of type    int.
  107.            This is followed    by one additional argument of type
  108.            XtVarArgsList.  This argument is    a nested list of
  109.            varargs returned    by _X_t_V_a_C_r_e_a_t_e_A_r_g_s_L_i_s_t.
  110.  
  111.       For more information on variable-length argument lists, see
  112.       the X    Toolkit    Intrinsics documentation.
  113.  
  114.       A number of resources    exist specifically for use with    this
  115.       and other simple menu    creation routines.  For    a complete
  116.       definition of    RowColumn and its associated resources,    see
  117.       _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  118.  
  119.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  120.       Returns the RowColumn    widget ID.
  121.  
  122.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  123.       _X_m_C_r_e_a_t_e_R_a_d_i_o_B_o_x(_3_X),    _X_m_C_r_e_a_t_e_R_o_w_C_o_l_u_m_n(_3_X),
  124.       _X_m_C_r_e_a_t_e_S_i_m_p_l_e_C_h_e_c_k_B_o_x(_3_X), _X_m_C_r_e_a_t_e_S_i_m_p_l_e_R_a_d_i_o_B_o_x(_3_X),
  125.       _X_m_R_o_w_C_o_l_u_m_n(_3_X), and _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_R_a_d_i_o_B_o_x(_3_X).
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.